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PREFACE 


The System Generator (SGEN) program described in this manual may be 
used only with the V5A or later versions of the Advanced Monitor Soft- 
ware System for PDP-15/20/3 0/40 configurations. 

To New Users 


The SGEN program provides the user with the means to rapidly tailor 
the general-purpose ADVANCED software system provided by Digital into 
a system optimized for his particular needs. 

Prerequisite 

In the preparation of this manual, it was assumed that the reader is 
familiar with the Advanced Software System; e.g., its Monitor and 
Utility programs, etc. 

PDP-15/20/3 0/40 ADVANCED MONITOR SOFTWARE SYSTEM MANUAL, DEC-15-MR2B-D 

This manual provides descriptions of system programs including discus- 
sions of: languages, utilities and application, operation, core 
organization, and input/ output operations within the Monitor environ- 
ment. 

PDP-15 UTILITY PROGRAMS MANUAL, DEC-15-YWZB-D 

The PDP-15 Utility Programs manual is comprised of a set of individual 
manuals, each of which describes the operation and use of a PDP-15 
Utility Program. The manuals which make up the Utility Programs set 
are listed in the following Application Guide. In addition, the guide 
also indicates the order number of each manual and the specific PDP-15 
Monitor Software Systems in which the program described may be used. 

The Utility Manuals may be ordered either individually, by using the 
title and order number given with each manual or as a set by referenc- 
ing "PDP-15 Utility Programs Manual, DEC-15-YWZB-D" . 
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APPLICATION GUIDE 


PDP^IS Utility Program Manuals and the Application of Each 


Manu al 

Applies to 

Monitor : 


Title 

Order Number 
(DEC-15-YWZB- ) 

DOS 

ADV 

B/F 

BASIC I/O 

DDT 

Utility Program 

DNl 

/ 

/ 

/ 

/ 

CHAIN & EXECUTE 
Utility Program 

DN2 

/ 

/ 

/ 

/ 

SGEN 

ADVANCED Monitor 

DNS 


/ 



MTDUMP 

Utility Program 

DN4 

/ 

/ 


/ 

PATCH 

Utility Program 

DNS 

/ 

/ 

/ 


EDIT 

Utility Program 

DN6 

/ 

/ 

/ 

/ 

UPDATE 

Utility Program 

DN7 

/ 

/ 

/ 


LINKING LOADER 

DNS 

/ 

/ 

/ 

/ 

PIP 

ADVANCED Monitor 

DN9 


/ 

/ 

/ 

PUNCH 

Utility Program 

DNIO 




/ 

SRCCOM 

Utility Program 

DNll 

/ 

/ 

/ 


SGEN 

DOS Monitor 

DN12 

/ 




PIP 

DOS Monitor 

DN13 

/ 




Disk SAVE/RESTORE 
Programs 

DN14 

/ 

/ 

/ 




















































To Users Familiar with Previous Versions of SGEN 


This new SGEN program provides the user with greater power and flexi- 
bility in the generation of new systems and, as a major new feature, 
permits the straightforward and rapid modification of existing systems. 
In modifying an existing system, the user may alter: 

CD API and Teletype usage, 

(2) system I/O devices and device handlers, 

(3) the contents and order of the system Skip Chain, 
and 

(4) the system .DAT slot assignments. 

The new features offered by SGEN in the generation of new systems in- 
clude: 

1. The complete deletion of all unwanted device handlers 
or system programs from new systems. 

2. The ability to add user programs to the new system as 
system programs. 

3. The optional addition of a system fQ core dump area. 

4. The ability to re-order system programs and to specify 
the actual length of the system (specified in 400g-word 
blocks) . These capabilities permit the optimization 

of program loading times for DECtape systems. 
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SECTION 1 


INTRODUCTION 


1 . 1 SYSTEM GENERATOR 


A general-purpose ADVANCED Monitor software system is supplied with 
each PDP-15 configuration which includes some form of mass storage 
(e.g., DECtape or DECdisk) and DECtape or magnetic tape for backup. 
A system Generator program (SGEN) , provided as part of the general- 
purpose package, enables the user to tailor and add to the supplied 
software in order to develop a resident software system unique to 
the installation or to his specific needs. 

The general-purpose software is normally supplied to the PDP-15 
user on a DECtape. This general-purpose DECtape contains all of 
the standard PDP-15/20 System Programs, Utility Programs, and I/O 
device Handlers supplied and supported by DEC; it should never be 
modified, as permitted by SGEN, but should be maintained as a 
master reference tape. 

1.2 SGEN, BASIC UNITS AND FEATURES 

SGEN provides the user with two basic capabilities: 

1) it may be used to modify an existing software 
system (see 1.2.1), 

2) it may be used to generate a new (specialized) 
system from either the master general-purpose 
system or a previously generated system (see 

1.2.2 and 1.2.3) . 

The SGEN program is divided into three units entitled SGEN, .SGEN2, 
and .SGEN3. During system generation the three program units are 
loaded into core in sequence with each succeeding unit overlaying 
the resident unit. Only the first unit, SGEN, is required in the 
modification of an existing software system; all three units are 
required in the generation of a new software system. 

1.2.1 SGEN Program Unit 

This program unit enables the user to alter or to determine system 
parameters for I/O devices. Device Handlers, .DAT slots and Tele- 
type^ and API usage. The SGEN unit features include 1) enabling 
the user to specify many handlers for one device, 2) the formation 
of a new skip chain by re ferencing one on an existing system, and 
^Teletype is the registered trademark of the Teletype Corporation. 
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3) the alteration of .DAT slot assignments using standard monitor 
assign commands. The modification of an existing software system 
is terminated on the completion of this program unit. 

1.2.2 .SGEN2 Program Unit 

In the development of a new software system, unit .SGEN2 is called 
into core by and overlays the SGEN unit on completion of its opera- 
tions. The capabilities offered by .SGEN2 are related to SYS file"^ 
programs, the system control Q ( tQ) area, the system SYSBLK area 
and the system monitor commands (in SKPBLK) . Program unit .SGEN2 
allows the user to: 

1) delete the area from the new system, 

2) delete SYS file system programs, 

3) set up file storage and control areas in the new 
system for the addition of new SYS file programs 
to the system. 

4) permit the re-ordering of the location of the SYS 
files on the new system medium. 

The system directory of the new system to be generated is automatic- 
ally updated during .SGEN2 operations to include the names and 
starting block numbers of all SYS files to be included in the new 
system. 

1.2.3 .SGEN3 Program Unit 

The .SGEN3 program unit is called into core by and overlays unit 
.SGEN2 on completion of its operations. The capabilities provided 
the user by the .SGEN3 unit include: 

1) the ability to delete from the system library 
(.LIBR BIN) the program units of user-deleted 
handlers (.SGEN2 operation); 

2) the ability to update the desired versions of 
the Object Time System (OTS) REAL and INTEGER 
software routines (EAE or non-EAE) into the 
new system library; 

3) the ability to transfer selectively the reloca- 
table files contained by the Old System input 
source into the new system. 


During the operations of this program unit, version C of the system 
device handler is automatically relocated and placed into the cor- 
rect area of the new system. On completion of the .SGEN3 program 
unit , th e nonresident monitor is called back into core. 

■^SYS files are system programs which are loaded by the entry of a 
unique keyboard command. The file name extension "SYS” identifies 
these files. t o 



1 • 3 SGEN OPERATIONS 


In order to develop a new system (see Figure 1-1) the System Genera- 
tor program requires: 

1) a "current" operating system from which the monitor 
and the required program units of the SGEN program 
may be loaded; 

2) an "old System" input source from which the "current" 
system can obtain inputs required to construct the 
new system; 

3) a "new system" output device on which to 
build the desired system. 

In many cases, both the "current" and the "Old" systems may be the 
same system; for example, when a new system is being generated 
from the Master DECtape supplied by Digital, all required inputs may 
be obtained from the single master source. 

The operations of the System Generator are carried out on an inter- 
active program/user basis via program printouts and user keyboard 
inputs. A step-by-step procedure illustrating the program printouts 
and required user responses for the System Generator operations is 
given in Section 2. 

System generation may be carried out from DECtape to DECtape, DEC- 
tape to DECdisk, DECdisk unit to DECdisk unit, and DECdisk unit to 
DECtape . 

1.3.1 Pre-Operational Considerations 

Careful planning is necessary to ensure that the most efficient 
system will be developed for the user*s particular needs. Some 
items to be considered in the pre-operational planning of a new 
system generation are described in the following paragraphs. 

1.3. 1.1 New System Size -- 

The size of the system to be developed must be calculated to 
determine if it will fit the selected output device. The maximum 
length, in 400g-word blocks, for systems on DECtape or DECdisk 
are: 


1) 

DECtape — 

llOOg blocks 

(0 - 

1077g) 

2) 

DECdisk — 

lOOOg blocks 

(0 - 

777g) 


1-3 




Figure 1-1. SGEN 



-onSf Information Flow Diagram 
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One procedure which could be used to determine the number of free 
system blocks available for adding programs would be to: 

1. Call PIP and obtain a directory listing using 

the PIP "L" command. This will give the number of 
free system blocks, the number of SYS file blocks, 
and the name and number of blocks occupied by each 
relocatable file. 

2. Call PATCH and obtain the size of each SYS file 
through the use of the PATCH "NB" command. Using 
the NB command (e.g., [SYS file name] NB ) for each 
SYS file named in the monitor directory will give 
the size in blocks of the system area allotted to 
each SYS file. 


If MACROI and F4l programs are present on the "Old System" and 
the new system is to have a core size larger than 8K, an additional 
100 g system blocks will be freed by the automatic deletion of 
these programs (40g blocks apiece) . 

If a system without a iQ area is used as the Old System, the size 
of the 'hQ area for the new system, if desired, must be subtracted 
from the number of free blocks in. the old system in order to deter- 
mine the number of blocks available for additional programs (e.g.. 
Master tapes distributed by DIGITAL do not contain areas) . 

1.3. 1.2 CALCULATING fQ AREA 

The System. Generator will reserve 20 g blocks for each 4K of 
core specified by the user as the iQ area. A smaller 'tQ area than 
core size would result in the loss or clobbering of system files 
if a command is given. A system with no area will not allow 

a '^00 command to be executed, but will wait for another unit number. 

NOTE 

The deletion of the '^Q area from a system prohibits 
the use of the ^^0 command but does not remove the 
iQ function from the system. Core images may be 
dumped onto any non-zero (non-system) device by the 
use of the 'hQ command (e.g., fQ0 cannot be used, 
however, 'tQl can) . 

1.3. 1.3 MACROI AND F4I 


The MACROI and F4I programs supplied on the Master DECtape are 
special programs intended for use in 8K systems only. Since these 
are special programs, they do not reside in the same areas as the 
standard system programs (SYS files) nor is the control data associ- 
ated with MACROI and F4I contained within the system in the same 
manner as for standard SYS files. 
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During the generation of systems larger than 8K, MACROI and F4I are 
automatically deleted from the new system. The new system, however, 
will contain the control data associated with these programs. 

During the development of 8K systems the user is permitted to option- 
ally add either or both of these special programs to the new system. 
The optional "ADD" feature causes the areas of the new system medium, 
which would normally be occupied by the added program unit(s), to 
be reserved and protected. If the "Old System" being used in the 
generation procedure contains MACROI and F4I, these programs (if 
added) are installed into their reserved areas during the last phase 
of the system generation. If the Old System does not contain MACROI 
and/or F4I, special procedures (described in 3.14.1) must be performed 
to install either or both of these programs into the new system. 

If the procedures described in Section 3 are not followed an 8K 
system will be generated which will respond to load commands for 
either of these programs by: 1) loading unknown data (garbage) 
from the area reserved for but not containing the called program, 
and 2) attempting to execute the unknown data. 
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SECTION 2 


SYSTEM GENERATION, STEP-BY-STEP PROCEDURE 


2 . 1 CONTENTS 


A complete step-by-step system generation procedure is presented in 
this Section. The procedure itemizes and describes each possible 
operation. Teletype printouts of the System Generator outputs 
and user inputs are also illustrated where applicable. 

2.1.1 Procedure Notes and References 


Where necessary, examples and notes (both directive and explanatory) 
are given in the procedure itself. Paragraph references are 
given in the procedure for supplementary data contained by Section 3 
"SGEN OPERATIONS, SPECIAL CONSIDERATIONS”. 

2.1.2 Procedure Headings 

The column headings used in the tabular procedure format and the 
meaning of each are as follows : 


1. ITEM - reference number. 

2. PROCEDURE - a description of each SGEN Program 

printout made and the required user 
response is given in this column. 

3. PRINTOUT - a typed representation of the actual 

Teletype printout of each output is 
given in this column. Normally, 
printouts are printed on a single 
line; however, manual page format 
space restrictions require the longer 
messages to be illustrated on two or 
more lines. 

4. REFERENCE - paragraph numbers which identify 

detailed descriptive data, normally 
concerning the selection of a re- 
sponse, are presented in this column. 


2.1.3 Conventions Used in Procedure 


The following conventions are used throughout the SGEN Program pro- 
cedure : 


1. Query printouts terminated in a ? require either 
Y (yes) or N (no) response from the user. 
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a. The ? symbol may be followed by paren- 
theses containing the response (Y or N) 
given in the generation of the old sys- 
tem. For example, the printout 

7 CHANNEL MAGTAPE (Y) 

indicates that the old system response 
had been Y (yes) • 


b. In BATCH mode, all Y or N user responses 
MUST be terminated by a ^i(CRLF) entry. 


2. In the SGEN Program, procedures incorporating informa- 
tion from an old system and which require a response 
different from Y or N may be followed by a set of 
brackets [ ] containing the old system response. (The 
bracketed symbols represent the response given during 
the generation of the old system.) 

For example, the printout 

MAX. SYSTEM BLOCK # [1077] 

requests the entry of the number of the system block 
which is to contain the last information to be stored 
on the tape; the number [1077] indicates that the old 
system response had been number 1077. 

3 . SGEN Program queries which require or provide for a 
multiresponse are formatted as follows: 

FORMAT EXAMPLE 

(a) Message terminated in a NEW HANDLERS: 

colon is printed 

(b) CR,LF is performed and an > 

angle bracket is printed 

The user responds by entering the needed responses, 
one response per line ( > is echoed^^at start of 
each line until all entries are made"^. The response 
series is terminated by entering (after > ) the word 
DONE or, in a non-Batch mode, a single ^ . 

For example: 

NEW HANDLERS: 

>DRA 

>DRB 

>DONE (or ) 

4. An ALT MODE response is echoed by the Teletype as a 
dollar sign $. 

NOTE: ALT MODE responses are not permitted 

in Batch mode. 


^NOTE: IF a > is preceded by X (i.e., *X >*) then preceding line 

was in error (ignored) . 
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5. SGEN Program operations are divided into five sec- 
tions identified by the letters A., B., C. , D., 
and E., which appear as the first letter in the 
printout which introduces the section. A control 
P ( '^P) command issued at any time within any sec- 
tion of SGEN returns the procedure to the first 
statement of that section. This sectionalization 
of the SGEN programs with respect to the user of the 
fP command enables the user to correct any mistakes 
made within a section rather than requiring the 
entire procedure to be repeated. The ITEMS of the 
following procedure at which the SGEN program sec- 
tions are introduced are: 


Section A. 

ITEM 

12 

Section B. 

ITEM 

23 

Section C. 

ITEM 

26 

Section D. 

ITEM 

27 

Section E. 

ITEM 

28 


6. Printout operations may be terminated line by line 
by the entry of a control U (I^U); the printout will 
be terminated on the line and character printed at 
the time of entry, and the next line will be output 
(if one exists) . Individual characters may be deleted 
(erased) from an input by using the Rubout (echoes \ 
symbol for each character deleted) . 


7. The representative printouts illustrated under the 
column "PRINTOUT" use the following conventions: 


a) Required user inputs are indicated as under- 
lined areas. For example: 

NEW SYSTEM? (The underlined area indicates 

that the user response should 
be entered at that point) 

b) Unknown numeric values are indicated by the letters 
"XX". For example: 


fQ AREA SIZE [XX] 


(user response) 



unknown numeric value) 


2.2 PREPARATORY DEVICE/. DAT SLOT ASSIGNMENTS 


The .DAT slot assignments which must be made for the generation of a 
new system and the updating of an old system are given in the follow- 
ing paragraphs . 
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2.2.1 New Systems 


The generation of new systems requires the following assignments: 


-14 Old system The old system does not have to be 

the current system; however, both 
systems must be V5A or later sys- 
tems (current system means the sys- 
tem being used) . 

-15 New system The device on which the new system 

is to be generated must be assigned 
to this .DAT slot. The contents of 
this device medium are ignored and 
overwritten. 


In 8K, when generating a new system onto a device different from 
the old system device, the A'^ handler should be assigned the old 
system device, and the handler assigned for the new device. The 
handlers must be assigned in this manner since two device A handlers 
and the SGEN program cannot fit into 8K of core. 

EXAMPLE: The following is an example of the device handler and .DAT 

slot assignments which are made in a typical DECtape system SGEN 
operation. 

Device Handler and Unit .DAT slot 

Old System DTAl -14 

New System DTA2 -15 


2.2.2 Updating Old Systems 

In updating old systems, the device assigned to .DAT slot -15 is 
ignored and the system contained by the device assigned to .DAT-14 
is modified. In this type of operation: 

1) .DTA-15 should be assigned to same device as 
.DAT-14 

2) When updating, the device on -14 must be WRITE 
ENABLED . 

2.3 STEP-BY-STEP PROCEDURE 

The operations which may occur in the use of the ADVANCED Monitor 
System Generator are given in the following table. 


^Refer to the ADVANCED Monitor manual for a description of the avail- 
able Device handlers . 
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Table 2-1 Step-by-Step Procedure 


ITEM PROCEDURE 


PRINTOUT REFERENCE () 


SECTION 1, SGEN 

1. Call system generator by $SGEN 

typing SGEN 

2. Query- NEW SYSTEM 

Answer Y (yes) or N (no) 


NOTE: If answer given is N (no) GO TO ITEM 9A for next 

sequential operation. 


3 . Query- 

Answer DK for DECdisk 
Answer DT for DECtape 

Old system device indicated 
in query brackets. 

4. Statement describing 
device assignments 

(the symbol I 1 represents 
device and unit number) 

5 . Query- 

Select and type in desired 
system core size or if old 
system size is OK, enter a 
(CRLF) only. 

6 . Query- 

Answer Y (yes) or N (no) ; 
answer given in ol3. system 
is indicated in parentheses. 


SYSTEM DEVICE [ ] 


NEW SYSTEM ON cm FROM OLD 
SYSTEM ON r I 


CORE SIZE (8, 12, 16, 20, 24, 
28, OR 32) [XX] 

(3.2.1) 

iQ AREA? ( ) (3.2.3) 


NOTE: If the answer to ITEM 6 is Y, and 12K or more of core has 

been specified, SGEN will print the following query 


fQ AREA SIZE [XX] 


Enter desired size; if the size 
in brackets (specified system 
core size) is acceptable, enter 
a (CRLF) . (The iQ area size 
cannot be smaller than the sys- 
tem core size.) 

7. Query- EAE? ( ) (3.2.4) 

Answer Y (yes) or N (no) ; old 

system answer indicated in 
parentheses . 

8. Query- DELETE DISCARDED HANDLERS 

Answer Y (yes) or N (no) FROM .LIBR? (3.2.5) 
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ITEM 

PROCEDURE 

PRINTOUT 

REFERENCE ( ) 

9 . Query- 


MAX. SYSTEM BLOCK # 

[1077] 


Enter octal number of block 
which is to be the last ac- 
cessible block in the system 
The number within brackets 
represents the last block in 
the old system 


NOTE: If the SGEN program is to be used to modify an old system 

(answer to Item 2 is Y) , it will print out the following 
query at this point: 

MODIFY SYSTEM ON XXX 

where XXX represents the name 
and unit number identification 
(e.g.r DKl) of the device con- 
taining the old system. 


If the device identification given is not correct, an error 
was made in preparatory .DAT slot assignments. 


10. Query- API? ( ) (3.2.2) 

Answer Y or N 

11. Query- 33TTY? ( ) (3.2.7) 

Answer Y or N 


12. Query- 

Answer Y or N 


A. ALTER I/O DEVICES OR 

HANDLERS? (3.2.8) 


NOTE: a. If an N answer is given for ITEM 12, the procedure goes 

to ITEM 23 for the next sequential operation. 

b. If a Y answer is given for ITEM 12, the operations de- 
scribed in ITEMS 13 through 22 are performed. 

THE ENTRY OF 'bP AT ANY POINT IN THESE OPERATIONS RETURNS 
SGEN TO ITEM 12. 

13. Statement, TO BE KEPT: (3.2.8) 


NOTE: The statement of ITEM 13 introduces a series of individual 

multi- line query groups (1 per standard device) which 
established the devices and device handlers to be kept in 
the system or added to the system. The following is an 
example of a device query group (paper tape punch) and 
instructions as to how the queries are to be handled: 

Instruction Printout 

a. Answer Y to keep punch, N to PP? 

drop punch and skip to next 
query group 
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ITEM 


PROCEDURE 


PRINTOUT 


REFERENCE ( ) 


b. Handler Version A. Answer Y PRA? 

to keep, N to drop. 

c. Version B, Y to keep, N to PRB? 

drop. 

d. Version C, Y to keep, N to PRC? 

drop. 

e. Go-Ahead symbol, type in > 

mnemonic of any PP handler to 

be added. If no more entries, 
type in DONE or CRLF { J ) . 

Refer to 3.2.8 for a detailed 
description of how to add 
handlers here. 

f. SGEN prints the skip lOT as- PSF=70)af201 

sociated with the device for 

user convenience. 


NOTE: ITEMS 14 through 21 illustrate the standard query groups 

normally presented to the user. 


14. Paper Tape Reader PR? 

Query group PRA? 


Paper Tape Punch 
Query group 


DECtape Query group 

NOTE: If DECtape is the selected 

system device, its printout 
will be formatted as shown 
for the DECdisk in this pro- 
cedure (ITEM 17) . 


RSF=70)2flJ2fl 


PSF=7002j2fl 


DECdisk Query group 

NOTE: Group format shown here would 

occur if DK was selected sys- 
tem device, otherwise its for- 
mat would be the same as shown 
in ITEM 16. 


DTDF= 7)2(7 6)2(1 
DTEF=7)2(7561 

DK IS SYSTEM DEVICE AND 
DKC IS SYSTEM HAND 


DSSF=7)2(7)2()2(1 
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ITEM 


PROCEDURE 


PRINTOUT 


REFERENCE ( ) 


18. Magnetic Tape MT?_ 

MTA? 

MTC? 

MTF? 


MTSF=7J2f7341 

19. Line Printer LP? 

LPA? 


LSDF=7j2r65J2fl 

20. Card Reader CD? 

CDB? 


RCSF=7)2f67JZfl 

RCSD=7)2f6721 

21. VP5A Display VP? 

VPA? 


SDDF=7jaf0521 

22. Query- ADD NEW DEVICES (3.2.8) 


NOTE: The query of ITEM 22 gives the user an opportunity to include 

any additional I/O devices and their handlers in the system 
being developed. 

AN (no) answer to the query causes SGEN to go to the opera- 
tion presented in ITEM 23. 

A Y (yes) answer to the query causes SGEN to enter the series 
of operations given in ITEMS 22a through 22. 

DETAILED INSTRUCTIONS ARE NOT GIVEN FOR ITEMS 22a THROUGH 
22b; REFER TO REFERENCES PARAGRAPH (S) FOR INFORMATION. 


22a. Query- 

Enter a unique 2- letter name. 

22b. Query and go-ahead symbol. 

Enter handler mnemonics - one 
per line. Terminate list by 
entering DONE after symbol. 


22c. Query and go-ahead symbol. 
Enter needed skip IOT*s 
for device named in Item 
22a. lOT format is: 

SKIP _ 6-digit octal number 
MNEMONIC ” representing lOT in- 
struction. 


DEV NAME (3. 2. 8.1) 

NEW HANDLERS: 

(3. 2. 8. 2) 

> 

>DONE (or-*^ ) 

SKIP lOTS; 

> (3. 2. 8. 3) 

> DON E (or J) 
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ITEM 

PROCEDURE 

PRINTOUT 

REFERENCE ( ) 

22d. 

Query- 

ADD I/O DEVICES ?_ 

(3.2.8) 


NOTE: The query of 2 2d. enables the user either to repeat ITEMS 22a 

through 22c. for the entry of another device, its handlers 
and its skip IOT*s or to exit from this operation and go to 
ITEM 23. 

Answer Y to repeat cycle 

N to exit to ITEM 23. 

23. Query- 

A Y answer causes the program 
to print out the system skip 
chain as derived from old sys 
tern tape. 

An N answer advances the pro- 
cedure to ITEM 24. 


NOTE: It is advisable to obtain a printout of the skip chain to 

ensure that all of the desired skip IOT*s and only those, 
are included in the new system. (Refer to paragraph 3.2.9 
for more detailed information concerning this operation.) 


The following is an example of a Skip Chain printout, the 
function for each (not printed during System Generation) 
is also given: 


*a) 

Power Fail 

SPFAL 

b) 

DECtape Done Flag 

DTDF 

c) 

DECdisk Done 

DSSF 

d) 

Mag. Tape Done or Error 

MTSF 

e) 

Store, Display Done 

SDDF 

f) 

Card Column Ready 

RCSF 

g) 

Card Done 

RCSD 

h) 

Line Printer Done 

LSDF 

*i) 

Clock Done 

CLSF 

j) 

Reader Done 

RSF 

k) 

Punch Done 

PSF 

*1) 

Keyboard Done (TTA) 

KSF 

*m) 

Teleprinter Done (TTA) 

TSF 

n) 

DECtape Error Flag 

DTEF 

*o) 

Non-Existent Memory Ref. 

MPSNE 

*p) 

Memory Protect Violation 

MPSK 

*q) 

Memory Parity Error 

SPE 


*These skips are associated with permanent resident moni- 
tor handlers and functions, they will always appear in 
the Skip Chain unless specifically deleted. 


24. Query- CHANGE SKIP CHAIN ORDER? 

Answer Y or N (3.2.10) 


NOTE: An N answer to ITEM 24 advances the procedure to ITEM 25 for 

the next sequential operation. 

A Y answer to ITEM 24 causes the performance of ITEM 24a. 


B. DISPLAY SKIP CHAIN? 

(3.2.9) 
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ITEM 


PROCEDURE 


PRINTOUT 


REFERENCE ( ) 


24a. Statement and go-ahead 
symbol. In BATCH mode 
the user must type in 
-one per line- each SKIP 
lOT. In Non-BATCH mode 
the user may enter an 
ALT MODE command ($) and 
the first unused SKIP 
from the old order is 
automatically supplied 
on that line. Terminate 

list by entering DONE . 

25. Special Device questions. 

The user may have certain 
optional devices for which 
additional information is 
needed. The following ITEMS 
detail the questions asked 
in these cases: 

25a. 339 Display 

(1) Query- 339 LOAD DEFAULT LOAD? ( ) 

Answer Y if 339 table 

is to be included in 
the monitor. 

(2) Query- LOAD VC38 TABLE? ( ) 

Answer Y if a 339 push- 
down list is to be in- 
cluded in the monitor. 

25b. Magnetic Tape: 7 CHANNEL MAGTAPE? ( ) 

The assumption will be 7 
channel if Y is typed and 
9 channel if N is typed. 

25c. Line Printer 
Query- 

Answer with the maximum num- 
ber of characters which may 
be printed on one line. The 
number should be one speci- 
fied in the query. 

26. Query- C. DISPLAY .DAT SLOTS? 

Answer Y or N 


NOTE: An N answer to ITEM 26 advances the procedure to ITEM 26a for 

the next sequential operation. 

A Y answer to ITEM 26 causes a printout of an ordered list of 
the current new system .DAT slot assignments and will initiate 
ITEM 26a. 

The following is an example of the Printout of one possible 
.DAT slot arrangement for a 2 platter RF DECdisk system: 


LINE PRINTER LINE SIZE? 
120, OR 132) [XX] 


TYPE NAMES IN NEW ORDER 
($ CAUSES FIRST UNUSED 
SKIP FROM OLD ORDER TO 
BE SUPPLIED) : 


>DONE (or J) 

(3.2.10.1) 
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ITEM PROCEDURE PRINTOUT REFERENCE ( ) 

-15 DKA2 
-14 DKAl 
-13 DKA2 
-12 TTA0 
-11 DKAl 
-10 TTA0 

- 6 DKA2 

- 5 NONE 

- 4 DKA2 

- 1 DKA0 

1 DKA0 

2 DKAl 

3 DKA2 

4 TTA0 

5 PRA0 

6 PPA0 

7 DTAl 
10 VPA0 


26a. Query and go-ahead 
symbol 

Answer by entering 
a reassignment com- 
mand until all changes 
are made. 

Terminate operation 
by entering DONE 

Example: 

>A DTBl -13/DT2 10,-6/DT 3 
>DONE 


NOTE: If the procedure was intended for the modification of an Old 

System (ITEM 2 answered N) the operation would have been com- 
pleted by the termination of ITEM 26a. The completion of the 
procedure is indicated by the following printout: 

SGEN COMPLETE 
MONITOR 
$ 


27. Query- D. CHANGE SYS PROG.? 

Answer Y or N (3.2.13) 


NOTE: The query of ITEM 27 permits the user to initiate a cycle of 

operations during which System Programs may be deleted or 
added to the group to be installed in the new system. 

A Y answer to ITEM 27 initiates the operations presented in 
ITEMS 27a and 27b. An N answer to ITEM 27 causes the SGEN 
program to proceed to ITEM 28. 

27a. Statement followed by 

a series of one-per-line 
queries . 

Answer queries : 

Y to keep program, 

N to delete program. 


TO BE KEPT: (3.2.14) 

DTCOPY? 

SRCCOM? 

F4I? 

EDIT? TYPICAL EXAMPLE 

EDITVP? OF PROG. LIST 

MACRO? PRINTOUT 


ALTER .DAT SLOTS: (3.2.12) 


>DONE [orj) 


2-11 









ITEM 


PROCEDURE 


PRINTOUT 


REFERENCE ( ) 


PIP? 

F4? 

SGEN? 

DUMP? 

UPDATE? 

MACROI? 

CHAIN?__ 

PATCH? 


NOTE: If an 8K new system is being generated and the Old System does 

not contain F4I or MACROI, the following statement and queries 
are made to enable the user to add these files to the new sys- 
tem. 

TO BE ADDED: (3.2.14) 

F4I? 

MACROI? 

27b. Query- ADD SYS PROG.? (3.2.15) 


NOTE: A Y answer to ITEM 27b starts a cycle of queries (ITEMS 27c, 

d and e) designed to obtain the name, size and .DAT slot as- 
signments of each program to be added. .SGEN returns to ITEM 
27b and repeats the cycle until an N answer is obtained. 

An N answer advances the SGEN program to ITEM 28. 


27c. Query- 

Answer by entering 
desired name. 

27d. Query- 

Answer by entering in oc- 
tal the number of blocks 
required to store pro- 
gram. 

27e. Query and go-ahead 
symbol . 

Answer by entering 
desired .DAT slot 
assignments; termin- 
ate List by entering 
DONE. 


28. Query- 

Answer : 

Y if a multi-line print- 
out of system program 
names as they appear 
in the system is wanted. 
N if printout is not 
wanted. 


PROG. NAME (6 OR LESS ALPHA- 
NUMERIC) 

(3.2.15.1) 

# OF DEVICE BLOCKS [ ] 

(3.2.15.2) 


.DAT SLOTS (-15 TO 10 OR ALL) : 


> DONE {OR J ) 

E. DISPLAY PROG. ORDER? 

(3.2.16) 


NOTE: An example of a System Program Order printout obtained if ITEM 

28 is answered Y follows: 
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ITEM PROCEDURE PRINTOUT REFERENCE ( ) 

__ 

EDITVP 

PIP 

MACRO 

CHAIN 

F4 

DUMP 

DTCOPY 

PATCH 

UPDATE 

SRCCOM 

SGEN 


29. Query- 
Answer : 

N if no files are to be 
dropped; the procedure 
advances to ITEM 30. 

Y if changes are to be 
made; ITEM 29a is per- 
formed . 

29a. Introductory 
statement 

followed by first of 
a list of queries . 
Queries are to be 
answered Y to keep 
file, N to drop file. 


NOTE: The following is an example of the type of file list obtained 

from ITEM 29a: 

Each query must be 
answered Y to keep 
named file, or N to 
delete named file. 


30. Query- CHANGE PROG. ORDER? (3.2.18) 

Answer Y or N. 


NOTE: A Y answer initiates the operation described in ITEM 30a in 

which the user is required to list, in desired order, all 
system programs. An N answer causes the procedure to advance. 


30a. Description statement RETYPE PROG. NAMES IN DESIRED 

and go-ahead symbol. ORDER ($ CAUSES FIRST UNUSED 

User must enter names PROG. FROM OLD ORDER TO BE 

of all programs in- ADDED AT THAT POINT) : 

eluded in system (one > (3.2.10.1) 

per line) in desired 
order. 

The use of the termin- 
ator "DONE" is illegal 
since all SYS file system 
programs must be included. 


TO BE KEPT: 
8TRAN BIN?_ 
FOCAL BIN?_ 

FNEW SRC? 

TIME BIN? 

TIMElj2f BIN? 
FOCAL XCT?__ 
FOCAL XCU? 
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ITEM 

PROCEDURE 

PRINTOUT 

REFERENCE ( ) 

31. 

Statement 

SGEN IN PROGRESS 

( fP illegal) 


NOTE: The statement of ITEM 31 indicates that the SGEN program is 

in the process of building the new system onto the assigned 
output device. The approximate time required for this opera- 
tion is : 


a) DECtape to DECtape ------------- 15 minutes 

b) DECtape to Disk- -------------- 10 minutes 

c) Disk to Disk ---------------- 1 minute 

d) Disk to DECtape- -------------- 10 minutes 


32a. Statement and List. 

A list of the handlers 
deleted from the new 
system library (only 
if ITEM 8 was answered 
Y) is output. 

32b. Statement and List. 

A list of all handlers 
which were not found 
in the old Library 
is output. 


DELETED HANDLERS: 
CDB. Example 

MISSING HANDLERS: 

RFE. 

RFF. > Examples 
LPA. ) 


33. Statement, SGEN COMPLETE 

System Generation 
complete, new system 
is on assigned out- 
put device medium. 
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SECTION 3 


SGEN OPERATIONS, SPECIAL CONSIDERATIONS 


3 . 1 CONTENTS 


This Section contains descriptions of the various considerations 
and alternatives of which the user should be aware in selecting 
his response to many of the queries presented during the System 
Generation procedure. 

3.1.1 Single Vs. Multi-System Users 

Much of the information given in this Section is based on the 
fact that the user is either a: 

1) Single-System User , has only one PDP-15 system 
available to him; or is a 

2) Multi-System User, has more than one PDP-15 sys- 
tem available to him. 

These terms, (items 1 and 2) are used throughout this Section. 
3.2 SELECTION OF RESPONSES 


The selection of the best possible responses to the System 
Generator queries, which present multi-response situations not 
necessarily obvious to the user, is the subject of many of the 
following paragraphs . Each of the following query-response 
descriptions is entitled according to the specific SGEN query 
with which it is concerned. 

3.2.1 Core Size (8, 12, 16, 20 , 24 , 28. or 32K) FXXl 

Normally single-system users will respond to this query with 
the actual size of the core contained by their system. One 
method, however, by which system users may delete the MACROI 
and F4l programs from their new system is to respond to this 
query with 3^. By specifying a 16K core size, the 8K user 
causes the automatic deletion of MACROI and F4I; the boot- 
strap will take care of the system core size at load time. 

Multi-system users may be required to run programs on systems 
having different sized cores. In such cases, the user normal- 
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ly specifies the core size of the smallest system on which he 
is required to run. In situations where one or more of the 
systems used has a core size other than 8K or some direct mul- 
tiple of 8K (i.e., 16, 24 or 32) the requirement of a 4K ON/OFF 
switch must be considered. 

3. 2. 1.1 4K ON/OFF Switch - In running a system with an extra 
4K of core on a computer not having an extra 4K of core of 
memory, the user must: 


1. Enter command X4K OFF immediately after load- 
ing the monitor. THIS COMMAND MUST BE RE- 
PEATED EACH TIME THE MONITOR IS RELOADED. 


In running a system that does not use an extra 4K of memory on 
a computer with an extra 4K of memory: 

2. Enter command X4K ON immediately after load- 
ing the Monitor. THIS COMMAND NEED ONLY BE 
ENTERED ONCE. 

To avoid having to enter the X4K OFF command repeatedly the user 
should specify during SGEN the size core which is a direct mul- 
tiple of eight and is equal to or less than the smallest system 
on which he is to run. 

3.2.2 API? 

Multi-system users who plan to run on both API and non-API sys- 
tems must consider the required API ON/OFF switch. 

3. 2. 2.1 API ON/OFF SWITCH - The command "API OFF" must be is- 
sued to the Monitor when it is loaded by users who run an API 
system tape on a non- API computer. THIS COMMAND MUST BE RE- 
PEATED EACH TIME THE MONITOR IS LOADED. 

The command "API ON" should be issued to the Monitor the first 
time it is loaded by a user who runs a non-API system tape on 
a computer containing the API option. THIS COMMAND ENABLES 
THE API OPTION UNTIL THE BOOTSTRAP IS RELOADED. 


If both API and non- API computers are to be used, it is recom- 
mended that the user answer the SGEN query "API?" with the no 
"N" response; this will permit him to use the required API ON 
command thus limiting the number of times which he has to issue 
the API switch command. 
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3.2.3 iQ AREA? ( ) 


The addition to or deletion from the new system tape of a iQ 
area is determined by this query. The fQ area is an area on 
the system device medium which is designated to receive a core 
image when fQpf is given on the console teletype or in the event 
of an unrecoverable error. The iQ area contains 20 g blocks 
for each 4K page of the specified core size. The deletion of 
the iQ area prohibits the use of the iQjZf command but iQ commands 
to other output devices will still be permitted. 

The deletion of this save area would permit the addition of 
more user programs onto the system tape or would speed the 
loading of the system programs by reducing the amount of tape 
which would have to be scanned. 

In systems without a iQ area^ all system programs will load 
faster (particularly the linking loader and DDT) if: 

1. The area freed by the deletion of the ^ 
area is not used for user programs. 

2. The user re-specifies the location of the 
MAXIMUM SYSTEM BLOCK to close up the freed 
area. 

If a iQ area is to be included (answer to item 6 is Y) and the 
core size answer is not SGEN queries the user as to the 

desired area size and indicates, within brackets, the default 
size (i.e., core size): 


iQAREA SIZE [XX] 

The user may specify any size desired as long as it is greater 
than the default value, or he may accept the default size by 
entering a CRLF ( J) . The multi-system user should specify 
the core size of the largest system that the new software sys- 
tem is to be used on, otherwise a iQ command entered while op- 
erating on a larger system will destroy blocks on the system 
tape . 

3.2.4 EAE? ( ) 

The answer to this query indicates to SGEN which version of 
the FORTRAN OTS REAL and INTEGER packages are to be included 

^NOTE : 8K systems may only have 8K iQ areas. 
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in the system library (.LIBR BIN). A non-EAE system can always 
work even on a machine with EAE. 

To determine if a tape is EAE or non-EAE, without using the 
.SCOM bit, obtain a listing of the system library with UPDATE 
L OPTION (.LIBR BIN). The file names of the REAL and INTEGER 
OTS packages are located near the end of the library and will 
be : 


RELNON 

INTNON 

RELEAE 

INTEAE 


for non-EAE systems 


for EAE systems 


Besides the bit in .SCOM+4, this is the only difference between 
EAE and non-EAE systems. 


3.2.5 DELETE DISCARDED HANDLERS FROM .LIBR? 


A Y answer to this query causes SGEN to delete, completely, 
from the new system tape library file, any handlers indicated 
during SGEN operations as unwanted. If anN answer is given, 
the unwanted handlers remain in the system library but are 
ignored during system operations (they cannot be used) . 

A Y answer frees useful device blocks on the system unit medium 
and speeds up the loading of wanted system programs by elimina- 
ting the need to search through unused data during load opera- 
tions . Once handlers are deleted from the library they are 
in the same category as user generated handlers which must be 
added by using the system generator and the library update 
program. 

3.2.6 MAX. SYSTEM BLOCK # [1077] 


This SGEN query permits the user to determine the overall length 
of the system file to be generated onto the new system unit 
medium by specifying the number (in octal) of the last access- 
ible block in the system. For DECtape the number specified for 
the maximum-sized system is: 1077g. For DECdisk the number 
specified cannot exceed 111 ^. For the RBJ?9 Disk the number is 
1^773 . 

If a DECtape system user has deleted the fQ area (see Procedure ITEM 6) 
and/or intends to discard handlers and/or system programs, he 
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may close up (shorten) the length of DECtape traversed in load- 
ing system programs by specifying a block number less than 1077 g 
by the number of unused freed blocks. 

The use of this query permits the user to system generate onto 
system devices which have less than 1100 ^ available 400g-word 
blocks (e.g., DECdisk) ; it also optimizes system loading on 
the DECtape device by eliminating the need to move tape over 
blank freed blocks during system program loading. 

3.2.7 33TTY ? ( ) 

If the system tape being generated is to be used on a computer 
having a model 33 Teletype unit as an input console device (e.g., 
PDP-9 systems in a BANK Mode operation) rather than the model 35 
unit normally supplied with PDP-15 systems; the use of the Moni- 
tor 33TTY ON/OFF switch must be considered. 

3. 2. 7.1 33TTY ON/OFF SWITCH - If the answer to the query 

of item is Y and the system is being run on a system having a 
model 35 Teletype unit, the command 33TTY OFF must be issued 
to the Monitor each time the Monitor is loaded. 

If the answer to the query of item is N and the system is being 
run on a system having a model 33 input device, the command 

33TTY ON 

must be issued to the Monitor when it is first loaded. THIS 
COMMAND ENABLES THE 33 TTY OPTION UNTIL THE BOOTSTRAP IS LOADED. 


For multi-system users who must employ both models 33 and 35 
it is recommended that this query be answered no "N" to limit 
the number of times that the switch command has to be entered. 

3.2.8 Deletion/Addition of I/O Devices and Handlers 


As indicated in the note of item 13, entire I/O Device Handler 
groups may be deleted by responding to the device name query 
with an "N" answer. 

A device is also automatically deleted if all of its handlers 
are deleted. The actual removal of a deleted handler from the 
new system library file (.LIBR BIN) is determined by the response 
to item 8. 
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Any number of handlers may be added to a device. 


The names of new device handlers must consist of three charac- 
ters; the first two characters of a handler name must be the 
assigned mnemonic of the device for which the handler is in- 
tended (e.g., PP__ for additional paper tape punch handlers). 
Each handler name must be unique within the system. The last 
character of a handler name must not be an octal digit. 

3. 2. 8.1 DEV NAME - The new device name entered must consist 

of two letters , octal numbers cannot be used. New device names 
cannot duplicate any previously entered names; all future refer 
ences to the new device must be made using the assigned two- 
letter mnemonic. 

3. 2. 8. 2 NEW HANDLERS - The names of new device handlers must 
be listed in response to this query (see item 22b) . New hand- 
lers are named and entered in the same manner as described in 
paragraph 3.2.8. 

3. 2. 8.3 SKIP lOTS - All skip lOTS associated with the new de- 
vice must be listed one per line after this query. The format 
in which the lOTS must be entered is as follows: 

[SKIP MNEMONIC] = [6-DIGIT OCTAL NUMBER] 

where the octal number represents in octal notation the actual 
skip instruction. For negative-type skip lOTS, a minus sign 
must precede the octal number: 

[MNEMONIC] = -[OCTAL NUMBER] 

The use of negative lOTS is not recommended; if the associated 
device is down, has been removed from the system, or if the 
system tape is being used on a system not containing the device 
the resulting state of the negative skip whenever the chain is 
scanned during an interrupt condition, will cause an unrecover- 
able error (illegal interrupt) if the negative skip is reached 
before the skip of the device which caused the interrupt. 

A listing of the standard device lOTS is given in Appendix A; 
non-standard device lOTS are assigned as a function of the 
required hardware interface design. 
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3.2.9 B. DISPLAY SKIP CHAIN ? 

It is advisable that the user answer this query yes (Y) . 

Any permanent skips deleted in the generation of the old sys- 
tem are automatically added at the end of the current system 
skip chain. 


If this query is answered Y, the permanent system skips deleted 
from the old system will appear in the resulting printout near 
the end of the skip chain list immediately preceding any newly 
added skips . 

The deletion of a permanent (system) skip reduces the size of 
the resident monitor by 4 words per skip instruction. Teletype 
skips should never be deleted nor any skips for hardware avail- 
able in the computer installation. 


The following skips are associated with permanent resident moni- 
tor handlers and functions and will always appear in the skip 
chain unless they are specifically deleted. Deletion of the 
following skips does not remove them from the system generator 
table; they are only removed from the skip chain itself. 


SKIP 


FUNCTION 

CLSF 


7000001 

Clock Done 

MPSNE 

= 

701741 

Non-Existent Memory Reference 

MPSK 

= 

701701 

Memory Protect Violation 

SPE 

= 

702701 

Memory Parity Error 

SPFAL 

= 

703201 

Power Fail 

KSF 

= 

700301 

Keyboard Done (TTA) 

TSF 

= 

700401 

Teleprinter Done (TTA) 


3.2.10 CHANGE SKIP CHAIN ORDER ? 

If the user wishes to change the order of the skip-chain or 
to delete permanent skips from the skip chain of the new sys- 
tem, this query must be answered Y. 


Assuming a Y response, SGEN then requires the user to enter 
a list of desired skips arranged in the required order (ITEM 
24a of the procedure) . The entry of this list not only re- 
orders the skip chain but also provides the means of delet- 
ing permanent skips from the chain. 
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Any system skips not entered in the re-ordering operation are 
dropped from the skip chain. 

As a reminder, skips deleted from the skip chain are still 
within the system and will reappear in the skip chain of any 
new system generated using this system as the "old system". 

3.2.10.1 Use of ALTMODE in Re-Ordering New System Tables - 
During the re-ordering of Old System SYS file and/or Skip 
Chain tables for use in the new system being generated, the 
ALTMODE keyboard input may be used to cause the direct trans- 
fer of a table entry from the old system table to the table 
being developed for the new system. This ALTMODE initiated 
transfer is a convenience feature which relieves the user 
of the need to retype all table entries particularly when the 
new table is to be formed by inserting new items between the 
items of the existing table. 

Each time the ALTMODE key is actuated, the item of the old table 
immediately following the last transferring item is moved into 
the next sequential position of the new table. For example: 
(ALTMODE symbolized by $) : 


OLD TABLE USER OPERATION NEW TABLE 


1 rrrrr:! 




g j m 

CHAIN 




DTCOPY 

PIP 



EDIT 


Vid ; w 

F4 



8,TRAN 

MACRO 



NEWNM 

1^— - — 1 


eg > > 

, PIP 


3.2.11 C. DISPLAY .DAT SLOTS? 


Unless the user is completely familiar with the default .DAT 
slot assignments (i.e., those of the "Old System") it is ad- 
visable that this query be answered Y. 

On receiving a Y response, SGEN prints out the default .DAT 
slot assignment list with the exception of those slots which 
cannot be changed (i.e., -2, -3, and -7). In the printout, 
the term NONE is assigned to free or unassigned .DAT slots and 
those of deleted devices. 
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3.2.12 ALTER .DAT SLOTS: 


This SGEN step offers the user the choice of either accepting 
the default .DAT slot assignments or of altering them. 

Acceptance of the default list is accomplished by terminating 
the operation with a "DONE" entry: 

ALTER .DAT SLOTS : 

>DONE 

Reassignment of .DAT slots is accomplished using the standard 
monitor ASSIGN (A) command (refer to Chapter 4, paragraph 
4. 3. 2. 8 of the ADVANCED Monitor manual, DEC-15-MRZA-D for a 
detailed description of this command) . For example: 

1) to make a single change in the assignment list such as 
the assignment of DECtape A handler to DECtape unit 1 on 
.DAT slot -11 , the following entry is required: 

ALTER .DAT SLOTS : 

>A DTAl -llj 
>DONE^ 

2) to clear a single .DAT Slot in the default chain, for ex- 
ample, .DAT Slot -11, the following entry is required: 

ALTER .DAT SLOTS : 

>A NONE -llj 
>DONEJ 

3.2.13 D. CHANGE SYS PROG ? 

If the user wishes either to delete programs from the system 
or to provide named areas for the installation of a program 
into the system, this query must be answered yes (Y) . 

3.2.14 TO BE KEPT: (i.e.. System Programs) 

The function of this procedure is to enable the user to speci- 
fy which system programs are to be included in the new system. 
A yes Y response to ITEM 27a causes SGEN to output line-by- 
line a list of queries, one per line, with each query com- 
prised of a system program name and a question mark. For 
example : 
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TO BE KEPT: 
F4I? 

EDIT? 

PIP? 


Each query represents a system program currently available in 
the SGEN data source (i.e.. Old System); the query must be 
answered Y if it is to be included in the new system, or no N 
if it is NOT to be included in the new system. 


NOTE 

The list printed in this procedure contains 
only the names of the system programs which 
are contained by the "Old System"; it does 
not necessarily contain a complete list of 
system programs as supplied on the master 
system tape provided by DEC. If F4I and/or 
MACROI have been deleted from the old system 
they will not be in the new system unless it 
is an 8K system (refer to paragraph 1.3. 1.3 
for details) . 


An N response to any of the queries frees the SYSBLK and tape 
storage blocks containing control information and the code for 
that program. If the freed areas are not used for a new program, 
the program "slot" in SYSBLK remains empty; however, during 
the actual generation of the new system onto the output device, 
SGEN will adjust the placement of the system programs to com- 
pensate for any contraction or expansion of the system program 
area required by the deletion and/or addition of programs. 


The following is a list of the System Programs normally supplied 
on a DEC Master System: 


F4I 


sSpecial programs for 8K systems only 
MACROI J 


EDIT 

EDITVP 

PIP 

MACRO 

CHAIN 

F4 

DUMP 

DTCOPY 

PATCH 

UPDATE 


SRCCOM 

SGEN 
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Any one or all of the above programs may be deleted from the 
new system during this procedure: 


NOTE 


The addition of a new System Program to a 
new system requires that a program slot be 
available for it in the system SYSBLK. Since 
the size of SYSBLK is fixed, only as many new 
system programs may be added as were deleted 
(the total is 12^^) . The deletion of F4I or 
MACROI programs does not free slots in SYSBLK 
since these are special programs. 


3.2.14.1 ADDING F4I AND MACROI PROGRAMS TO AN 8K SYSTEM - If 
a new 8K system is to be generated using an Old System which 
does not contain MACROI or F4l files, the user must do the 
following: 


1. Before starting the System Generation procedure 
the user must copy the contents of Jhe Master 
DECtape onto the new system medium. 

2. The System Generation procedure as described in 
Section 2 must be performed. At a specific point 
in the procedure (ITEM 27a) the user is asked the 
following : 


TO BE ADDED : 

F4I? 

MACROI? 


A Y (yes) response to either or both of the program queries 
will result in the setting of pointers within the System Genera- 
tor program which will reserve, for the new system, areas normal- 
ly occupied by the selected program(s). 

Any area reserved for F4I or MACROI within the system generator 
will correspond to that already occupied on the new system medium 
by a copied master file. During the construction of the new 
system, any added file (F4I or MACROI) will appear in the new 
system simply by being present within a reserved area. If 
either F4I or MACROI or both are not added, the copied files 
on the new system medium will be overwritten. 

^Use of the DTCOPY utility program is recommended; refer to 
the Utility Manual, DEC-15“Y\^ZA-D for a detailed description 
of this program. 
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3.2.15 ADD SYS PROG.? 


This item represents the entry/exit point of a 3-item cycle 
which enables the user to name, reserve storage area, and 
make .DAT slot assignments for each program to be added to 
the new system (one cycle per program) . 

Once the new system has been generated onto its medium, 
program and handler code files may then be easily added 
using monitor utility programs PATCH and UPDATE. 

A yes Y response to this query initiates the cycle of 
operations described in the next three paragraphs; a com- 
plete cycle is performed for each program added. 

3.2.15.1 PROG. NAME (6 OR LESS ALPHANUMERICS) . - The name 
of the system program to be described during the current 
cycle must be entered in response to this query. As indi- 
cated in the query, the name may be comprised of up to six 
characters which may be letters or numbers or some combina- 
tion of both. The name entered must be that which is to be 
used in calling the program during system operations; it 
must not duplicate a monitor or PATCH command name as it will 
be added to their command tables. 

3.2.15.2 # OF DEVICE BLOCKS [ ] . - The size of the named 

system program must be specified as the number (in octal) 
of 400g-word blocks which its code will require on the new 
system medium. The specified area will be reserved on the 
new system for the installation of the named program. 

NOTE 

In specifying the size of a System Program, 
the user must take into consideration the 
potential size of the Bank Bit Initializa- 
tion Routines which are added to the pro- 
gram file during installation. Normally, 
these routines will not be larger than 400g 
words, the size of one storage block. 

3.2.15.3 .DAT SLOTS (-15 TO 10 OR ALL):. - The .DAT slots 
to be assigned to the named program must be entered^ one 
per line, in response to this query. .DAT slots -2 and -3 
need not be mentioned in this operation; the use of .DAT 
slot -7 is illegal. The response "ALL" will cause the system 
loader to load all handlers in the positive .DAT slots when 
loading the program. 
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The .DAT slot list may be terminated when desired by enter- 
ing a "DONE" terminator. 


NOTE 


This is the last operation of an ADD cycle; 
the user is returned to ITEM 27a on comple- 
tion of the .DAT slot list where the cycle 
is restarted or an exit is made to ITEM 28. 


3.2.16 E. DISPLAY PROG ORDER 

The user may obtain an ordered listing of the system programs 
as they will appear in the new system being generated by enter- 
ing a Y response to this query. 

If the user intends to optimize the loading of system programs 
by re-ordering their placement within the system, it is advis- 
able that a printout of the current order be obtained at this 
time . 


3.2.17 DELETE RELOCATABLE FILES? 


A yes Y response to this query initiates a procedure which 
enables the user to select the relocatable files which he 
wishes to be included in the new system being developed. The 
procedure is carried out in the same manner as for the System 
Program's keep/drop procedure (ITEM 27a) ; the user is queried 
filename by filename as to which files are to be kept. Those 
files to which the response is no N are not included in the 
new system. The following files cannot be deleted from the 
system: 


DDT BIN 
.LOAD BIN 
EXECUT BIN 
RELNON BIN 
RELEAE BIN 
INTNON BIN 
INTEAE BIN 
.LIBR BIN 


3.2.18 CHANGE PROG. ORDER? 


An important factor in the optimal loading of system programs 
from DECtape with regard to time is the order in which the pro- 
grams are recorded onto the system DECtape. 
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The re-ordering of system programs during SGEN is permitted by 
this procedure. The more frequently used system programs should 
be placed at the beginning of the system program storage area 
to obtain the shortest loading times. 

The use of the ALTMODE command in the re-ordering operation 
is discussed in 3.2.10.1. 

A discussion of optimization of system program loading is given 
in paragraph 3.3. 

3.3 OPTIMAL LOADING OF SYSTEM PROGRAMS 

The SGEN program permits the user to order the system programs 
of a new system as he desires - a feature which is important 
in optimizing system program load time. 

The time required to load a system program from the system 
medium, particularly DECtape,can be significantly affected 
by the position of the program within the system. 

A diagram of the allocation of a typical 8K system on a DEC- 
tape is given in Figure 3-1. 

Referencing Figure 3-1, programs CREFI^, MACRO I , and F4l are 
present only in 8K systems; in larger systems these programs 
are overlayed by the ^ area, if it is kept, or their areas 
are freed. Areas freed by the deletion of system programs or 
by the deletion of the fQ area are opened for use by relocat- 
able programs . 

As shown in Figure 3-1, the tape area occupied by system pro- 
grams is located at the end of the system area. The system 
program area is automatically expanded or contracted by SGEN 
to accommodate the addition or deletion of system programs. 

The overall area occupied by the system can be reduced by 
the re- specif ication of the system maximum block number; 
this is permitted by SGEN and results in the movement of the 
system program area closer to the front of the tape. Shorten- 
ing the overall system length in this manner reduces the area 
available for relocatable files; however, this may be compensated 

^NOTE : CREFI is a 4-block area which is reserved for a cross- 

reference option in MACROI . 
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for by the deletion of unused relocatable files and the dele- 
tion of the IQ area. Normally, loading the monitor and a 
system program is accomplished in the following manner: the 
monitor is read into core from the top of the system tape by 
the bootstrap; the monitor, in turn, uses the bootstrap to 
load the SKPBLK and lOBLK areas. 

The monitor and the skip and I/O areas are located on the 
system tape in a sequential order and are spaced to permit 
their being read in a single continuous forward movement of 
the system tape. 

When the monitor receives a load system program ( SYS program) 
command, it reads into core the system loader (.SYSLD) using 
the bootstrap loader. The .SYSLD loader then reads, select- 
ively, the required system program handlers from the system 
library (.LIBR BIN). When the handlers are loaded into core, 
the bootstrap is then set up to load the requested system pro- 
gram. The placement on the system tape of .SYSLD with respect 
to .LIBR BIN and the organization of the handlers within the 
library permits the needed handlers to be read in a continuous 
forward movement of the system tape. The forward movement of 
the tape is continued through the tape System Program area 
during which the requested system program is read into core. 
The first .SYS program in the system program area is the first 
reached during the read operation; therefore, it will have the 
shortest possible load time. As illustrated in the above 
description, the contents of the system tape are organized to 
implement an efficient loading scheme. Loading efficiency for 
an individual system, however, can be further enhanced by: 

1. Shortening the system physical length by 
deleting unwanted relocatable files and 
the ^ Q area and specifying a smaller 
maximum system block; 

2. Re-ordering system programs to put the 
most used programs at the top of the tape 
system program area. 
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NOTES : 


1) [wri a indicates areas reserved for relocatable files. 

2) All numbers are given in octal. 
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100 DIRECT 



Figure 3-1. 


8K System Tape Allocations 
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APPENDIX A 


SGEN ERROR MESSAGES 


The error messages which may be output by SGEN during its opera- 
tions are described in the following table. 


Table A-1 SGEN Error Messages 


Printout Meaning 

GENERAL PURPOSE ERROR PRINTOUTS 


7 


(query 

repeated) 

The preceding query response was not 
intelligible; this indicator (?) is 
normally followed by a reprint of the 
query incorrectly responded to. 

SYM 

(query 

ONLY 

repeated) 

The preceding entry contained or was 
comprised of a numeric where a symbol 
was required. 

X 


The preceding entry was faulty and 
has been ignored by SGEN; normally 
this indication follows a text error 
message. For example: 



BAD DEVICE CODE 

X> 

"Y"/' 

(query 

'*N" 

repeated) 

The preceding response should have 
been either a yes (Y) or a no (N) 
and was incorrectly made. 

OCTAL # 

(query repeated) 

An octal number was expected as the 
preceding response and was not re- 
ceived. 

TOO 

(query 

LONG 

repeated) 

One of the preceding entry symbols 
was too long; it exceeded nine charac- 
ters . 
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SGEN OPERATIONAL ERROR MESSAGES 


Printout Meanin< 


SGNBLK WILL NOT FIT IN BUFFER 

ABORT This error message is output and 

operations are aborted if the core 
buffer available for the SGEN pro- 
gram unit is too small. This error 
occurs if incorrect device handler 
assignments are made. 

14 NOT VALID DEVICE 
Terminal error, this error occurs if 
the device assigned to .DAT slot -14 
is not a file-structured mass storage 
device. 

15 NOT A VALID DEVICE 
Terminal error, this error occurs if 
the device assigned to .DAT slot -15 
is not a file-structured mass storage 
device. 

15 ARE SAME 

This message is printed if the same 
device has been assigned to both 
.DAT slots -14 and -15 and it has 
been indicated to SGEN that a new 
system is to be developed. The 
query NEW SYSTEM? should be answered 
N if a new system is not to be made 
or iC should be used to reload the 
monitor. 

.DAT- 15 IS NOT THE SAME AS .DAT- 14 
DO YOU WISH TO PUT .DAT-14 INTO .DAT-15? 

This message is printed if the modi- 
fication of an old system has been 
indicated to SGEN and .DAT slots -14 
and -15 are not assigned to the same 
device. 

If the SGEN operation is to be the 
modification of an old system, the 
message query should be answered 
yes (Y) . 

If a new system is to be developed, 
answer the message query no (N) and 
SGEN will output: 

NEW SYSTEM? 

which should be answered Y. 

If the user enters a new device 
handler mnemonic and the first two 
letters of the entry are not the same 
as the device mnemonic, this message 
will be output and SGEN indicates that 
the last entry was ignored. A new 
corrected entry should then be made 
after the message go-ahead symbol. 


BAD DEV CODE 
X> 


.DAT -14 AND .DAT - 
NEW SYSTEM? 


.DAT SLOT - 
ABORT 
$ 


.DAT SLOT - 
ABORT 
$ 
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3CHAR 

X> 


NOT NEW 
X> 


OLD DEV 
X> 


OLD SKIP 
X> 


NOT lOT 
X> 


SGNBLK TOO BIG 


TOO MANY SKIPS 
ABORT 


BAD HANDLER 
EX: 

A DTA2 -4/DTl -5 

BAD UNIT # 

EX: 

A DTA2 -4/DTl -5 


BAD .DAT SLOT 
EX: 

A DTA2 -4/DTl - 


NO ROOM 
ABORT 


Device handler mnemonics entered by 
the user should be 3 characters in 
length; no more, no less. Enter the 
correct mnemonic after the message 
go-ahead symbol. 

This message is output if the last 
character of the last-entered handler 
mnemonic is an octal number rather 
than a letter or if the entered mnem- 
onic duplicated a previously entered 
mnemonic. The correct mnemonic should 
be entered after the message go-ahead 
symbol. 

The device code entered on the pre- 
vious line is found by SGEN to be 
the same as that of an existing de- 
vice. Enter a new code after the 
message go-ahead symbol. 

The last entered skip mnemonic or 
lOT number is a duplicate of an 
existing mnemonic or number. 

The number of the last entered skip 
lOT is not recognized by the system; 
the error should be corrected and 
the entry retyped. 

If the entry of new devices to be 
added to the system device table 
to exceed one block in size (400^. 
words) this message will be output. 
This error should never occur in 
normal use. 


The entry of more than 40^^ skips 
will cause this terminal error. 

This error message and example are 
output if an illegal handler name 
is entered in an A statement during 
,-6/DT -1 the alteration of .DAT slots. 

The use of an illegal unit number 
(not present) in an A statement 
during the alteration of .DAT slots 
,-6/DT -1 causes this error message and ex- 
ample to be output. 

The use of an illegal .DAT slot 
number in an A statement during 
the alteration of .DAT slots causes 
> ,-6/DT -1 this message and example to be out- 
put. 

If there is not enough room in core 
to permit the loading of the .SGEN2 
program unit this message is output. 
This error usually occurs if the wrong 
(too large) system device handlers 
have been assigned. 
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NOT UNIQUE 


TOO MANY SYSTEM PROG. 


SYSBLK OVFLO 
ABORT 


SYSTEM TAPE TOO FULL 
ABORT 


fP ILLEGAL 
ABORT 


In adding system programs to the 
new system, the last entered name 
duplicated one previously entered. 

This message is output if the user 
attempts to enter more than 12,^ 
system programs in the new system 
(excluding F4I and MACROI) . 

This terminal error occurs if the 
.DAT slot entries for added system 
programs exceed the area allocated 
for .DAT slots in the SYSBLK. 

On the completion of the Deletion 
of Relocatable Files operation SGEN 
automatically determines if the new 
system output medium can actually 
contain the system as defined by 
the user. If the system is found 
to be too large this terminal error 
occurs . 

A iP input has been made after 
SGEN had stated that such an input 
would be illegal. This is a term- 
inal error. 


NEW SYSTEM DEVICE MALFUNCTION 

This message is output and control 
is returned to the Monitor if SGEN 
cannot successfully copy the new 
system SYSfiles onto the new system 
medium . 


.LIBR BIN MISSING 
ABORT 


[Filename] MISSING 


REL [version] MISSING 
ABORT 

or 

INT [version] MISSING 
ABORT 


If, on the old system, the .LIBR 
file is found to be missing, SGEN 
will output this error message and 
will abort operations. 

If a permanent file is found to be 
missing, SGEN will output the name 
of the file and the word MISSING 
but does not abort. The missing 
file should be PIP*d onto the old 
system before the system generation 
process . 

If the system which the user is 
generating requires a different 
version of the REAL or INTEGER OTS 
routines than is available in the 
old system, the appropriate message 
is output and the operation is aborted. 
For example; 

RELNON MISSING 

ABORT 

is output and the operation aborted 
if the non-EAE version of the REAL 
routine is not on the old system 
and is required by the new system. 
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INTEAE OR INTNON NOT IN .LIBR BIN 

ABORT SGEN was unable to find any ver- 

sion of the OTS integer routine 
in the library (old system) . 

RELEAE OR RELNON NOT IN .LIBR BIN 

ABORT SGEN was unable to find any ver- 

sion of the OTS real (REAL) routine 
in the library (old system) . 

5 READ ERRORS If SGEN has difficulty in reading 

ABORT the .LIBR BIN file it will make the 

attempt five times then will output 
this message and will abort opera- 
tions . 


HANDLER XXC. MISSING 
ABORT 


NO ROOM 
ABORT 


SYS HAND TOO BIG 
ABORT 


If SGEN searches the library and 
cannot find the C version of the 
system device handler, it will 
output this message and will abort 
operations . 

If SGEN cannot find room in core 
for the specified system handler, 
it will output this message and 
will abort operations. This error 
should never occur. 

If the system handler is larger 
than 1400 q words in length, it 
will exceed the space available 
to it; SGEN then outputs this mes- 
sage and aborts operations. 
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APPENDIX B 


EXAMPLE, GENERATION OF AN OPTIMIZED 8K DECTAPE SYSTEM 


The following example represents the Teletype printout obtained 
during the system generation, onto DECtape, of a 15/20 DECtape 
system. The new system is being developed from the master DEC- 
tape supplied by Digital and is being optimized for an 8K "DEC- 
tape only" system application. Only small modifications to the 
procedure illustrated in this example need be made to develop 
systems larger than 8K. 

In the example, the new system to be developed has been optim- 
ized by: 


1. shortening the library (.LIBR BIN) by the dele- 
tion of all unused DECdisk handlers; 

2. reducing the size of the resident monitor by 
eliminating the skips for DECdisk, magnetic 
tape, line printer, card reader, and VP dis- 
play; since this is to be a DECtape only sys- 
tem. 

3. for user convenience, 8TRAN has been allotted 
an area in the new system as a SYS file and 
is deleted as a relocatable file. The 8TRAN 
program will be patched into the new system 
after SGEN as SYS file 8TRN; 

4. system program EDITVP is deleted since no VP 
display is included in the system; 

5. A ^ area is not included in the new system 
in order to save space; 

6. program loading is optimized by the specifica- 
tion of a shorter system length through the 
entry of a maximum system block number of 677g. 
Re-specification of the maximum system block 

# takes advantage of the deleted iQ area and 
all other freed areas to move the SYS files 
nearer the directory. 
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KM15 V5A 


$A DT0 -14/DTl -15 
$SGEN 

SGEN V4A 

NEW SYSTEM? Y 

SYSTEM DEVICE [DT] 

NEW SYSTEM ON DTI FROM OLD SYSTEM ON DT0 
CORE SIZE (8, 12, 16, 20, 24, 28, OR 32) [8] 
■tQ AREA? (N) N 
EAE? (Y) N 

DELETE DISCARDED HANDLERS FROM .LIBR? Y 
MAX. SYSTEM BLOCK #[1)?77] 677 
API? (N) N 
33 TTY? (N) N 

A. ALTER I/O DEVICES OR HANDLER? Y 

TO BE KEPT; 

PR? Y 
PRA? Y 
PRB? Y 

> 

RSF=70J2fl01 

PP? Y 
PPA? Y 
PPB? Y 
PPC? Y 
> 

PSF=700201 
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DT IS SYSTEM DEVICE AND DTC IS SYS HAND 
DTA? Y 
DTB? Y 
DTD? Y 
DTE? Y 
DTE? Y 
> 

DTDF=7j2f76j2fl 

DTEF=707561 

DK? N 

MT? N 

LP. N 

CD? N 

VP? N 

ADD NEW DEVICE? N 


B. DISPLAY SKIP CHAIN? Y 
SPFAL 

DTDF 

CLSF 

RSF 

PSF 

KSF 

TSF 

DTEF 

MPSNE 

MPSK 

SPE 

CHANGE SKIP CHAIN ORDER? N 

C. DISPLAY .DAT SLOTS? Y 

-15 DTA2 
-14 DTAl 
-13 PPC0 
-12 TTAJ2f 
-11 PRBi2f 
-10 TTA0 
-6 DTB2 
-5 NONE 
-4 DTC2 
-1 DTC0 

1 DTA0 

2 DTAl 

3 DTA2 

4 TTAO 

5 PRA0 

6 PPA0 

7 DTAl 
10 DTA2 
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ALTER .DAT SLOTS: 

> 


D. CHANGE SYS PROG.? Y 

TO BE KEPT" 

DTCOPY? Y 
SRCCOM? Y 
F4I? Y 
EDIT? Y 
MACRO. Y 
PIP? Y 
F.4? Y 
SGEN? Y 
DUMP? Y 
UPDATE? Y 
EDITVP? N 
MACRO I? Y 
CHAIN? Y 
PATCH? Y 

ADD SYS PROG.? Y 

PROG. NAME (6 OR LESS ALPHAMERICS) 8TRN 

# OF DEVICE BLOCKS [] 11 

.DAT SLOTS (-15 TO 10 OR ALL): 

>-15 

>-14 


ADD SYS PROG.? N 

E. DISPLAY PROG. ORDER? Y 

EDIT 

PIP 

MACRO 

CHAIN 

F4 

DUMP 

DTCOPY 

PATCH 

UPDATE 

SRCCOM 

SGEN 

8TRN 
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DELETE RELOCATABLE FILES? Y 


TO BE KEPT: 
FOCAL BIN? Y 
8TRAN BIN? N 
FNEW SRC? N 
TIME BIN? N 
TIME10 BIN? N 
FOCAL XCU? Y 
FOCAL XCT? Y 


CHANGE PROG ORDER? Y 

RETYPE PROG. NAMES IN SESIRED ORDER 
($ CAUSES FIRST UNUSED PROG. FROM 
OLD ORDER TO BE ADDED AT THAT POINT) 
>$EDIT 
>$PIP 

> $MACRO 
>$CHAIN 
>$F4 
>$DUMP 
>$DTCOPY 

> $PATCH 
>$ UPDATE 
>$SRCCOM 
>8TRN 
>$SGEN 

SGEN IN PROGRESS ( iP ILLEGAL) ’ 


DELETED HANDLERS: 

RFC. 

RFA. 

RFB. 

RFD. 

RFE. 

RFF. 

SGEN COMPLETE 
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DIRECTORY LISTING 


13 

FREE 

BLKS 


13 

USER 

FILES 


627 

SYSTEM BLKS 


.LOAD 

BIN 

36 

10 

DDT 

BIN 

37 

13 

EXE CUT 

BIN 

40 

3 

INTEAE 

BIN 

41 

1 

INTNON 

BIN 

47 

1 

RELEAE 

BIN 

54 

4 

RELNON 

BIN 

104 

4 

.LIBR 

BIN 

105 

123 

FOCAL 

BIN 

122 

23 

FOCAL 

XCU 

244 

27 

FOCAL 

XCT 

363 

1 

KM15 

SYS 

0 


SKPBLK 

SYS 

42 


lOBLK 

SYS 

46 


SGNBLK 

SYS 

52 


SYSHAN 

SYS 

56 


SYSBLK 

SYS 

61 


.SYSLD 

SYS 

62 


BITMAP 

SYS 

71 


DIRECT 

SYS 

100 


F4I 

SYS 

141 


MACROI 

SYS 

201 


EDIT 

SYS 

434 


PIP 

SYS 

446 


MACRO 

SYS 

466 


CHAIN 

SYS 

524 


F4 

SYS 

544 


DUMP 

SYS 

576 


DTCOPY 

SYS 

602 


PATCH 

SYS 

605 


UPDATE 

SYS 

614 


SRCCOM 

SYS 

624 


8TRN 

SYS 

636 


SGEN 

SYS 

647 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Prcjrnm Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 
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READER'S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual . 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 


Did you find errors in this manual? If so, specify by page. 


How can this manual be improved? 


Other comments? 


Please state your position. 



Date: 

Name: 


Organization: 


Street: 


Department: 


City: 

State: 


Zip or Country 
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